home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / chdir.man < prev    next >
Encoding:
Text File  |  1989-05-23  |  1.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. CHDIR                 C Library Procedures                  CHDIR
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      chdir - change current working directory
  10.  
  11. SSYYNNOOPPSSIISS
  12.      cchhddiirr((ppaatthh))
  13.      cchhaarr **ppaatthh;;
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      _P_a_t_h is the pathname of a directory.  _C_h_d_i_r causes this
  17.      directory to become the current working directory, the
  18.      starting point for path names not beginning with ``/''.
  19.  
  20.      In order for a directory to become the current directory, a
  21.      process must have execute (search) access to the directory.
  22.  
  23. RREETTUURRNN VVAALLUUEE
  24.      Upon successful completion, a value of 0 is returned.  Oth-
  25.      erwise, a value of -1 is returned and _e_r_r_n_o is set to indi-
  26.      cate the error.
  27.  
  28. EERRRROORRSS
  29.      _C_h_d_i_r will fail and the current working directory will be
  30.      unchanged if one or more of the following are true:
  31.  
  32.      [ENOTDIR]      A component of the path prefix is not a
  33.                     directory.
  34.  
  35.      [EINVAL]       The pathname contains a character with the
  36.                     high-order bit set.
  37.  
  38.      [ENAMETOOLONG] A component of a pathname exceeded 255 char-
  39.                     acters, or an entire path name exceeded 1023
  40.                     characters.
  41.  
  42.      [ENOENT]       The named directory does not exist.
  43.  
  44.      [ELOOP]        Too many symbolic links were encountered in
  45.                     translating the pathname.
  46.  
  47.      [EACCES]       Search permission is denied for any component
  48.                     of the path name.
  49.  
  50.      [EFAULT]       _P_a_t_h points outside the process's allocated
  51.                     address space.
  52.  
  53.      [EIO]          An I/O error occurred while reading from or
  54.                     writing to the file system.
  55.  
  56. SSEEEE AALLSSOO
  57.      chroot(2)
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0              August 26, 1985                        1
  64.  
  65.  
  66.  
  67.